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ABSTRACT 

Current  web  database  connectivity  solutions  lack  an  object- 
oriented  architecture  for  Java  applications.   In  particular,  Java  is 
object-oriented  and  most  legacy  databases  are  relational.   This  thesis 
proposes  a  design  and  implementation  of  an  object-oriented  Java  database 
class  hierarchy  for  relational  database  interfaces. 

The  work  reported  here  consists  of:  analysis  of  Java  Database 
Connectivity  specification,  discussion  of  two-tier  and  three-tier 
architectures  for  database  systems,  mapping  of  relation  database 
structure  to  an  object  model,  and  development  of  a  Java  based  framework 
to  exercise  the  JDBC  interfaces. 

This  work  provides  (1) :  an  object  model  for  the  relational 
database;  (2)  Integration  with  a  middleware  application  for  network 
connectivity;  (3)  A  Java  application  client  to  support  SQL  access  and 
manipulation 
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I .  INTRODUCTION 

A.  GENERAL 

The  advent  of  the  Internet  and  World  Wide  Web  (WWW)  has  opened 
opportunities  for  repository  computing  away  from  the  mainframe  to  the 
user's  desktop.   Application  and  database  servers  are  still  needed  to 
support  the  legacy  infrastructure  but  a  new  class  of  applications 
presented  through  a  web  browser  or  web  application  has  evolved.   Web 
computing  has  fostered  the  proliferation  of  HTTP  (hypertext  transaction 
protocol)  servers,  common  gateway  interfaces  (CGI),  and  web-crawling 
robots . 

Java,  developed  by  Sun  Microsystems,  has  become  a  leading  language 
for  web  based  interfaces  and  is  becoming  an  industry  standard  in  WWW 
browsers  and  tools.   Java  is  a  simple  and  robust  object-oriented 
language  used  to  extend  the  current  capabilities  of  the  hypertext  markup 
language  (HTML)  and  the  limited  options  in  CGI  programming  through 
browser-based  programs  known  as  applets.   Java  also  supports  the 
development  of  portable  applications  requiring  Java  Virtual  Machines  for 
execution. 

Government  agencies  are  now  embracing  Internet  and  repository 
technologies  in  the  execution  of  their  information  distribution  model . 
The  Modeling  and  Simulation  Resource  Repository  (MSRR)  is  one  such 
program.   The  MSRR  is  a  collection  of  M&S  resources  and  resource 
references  implemented  using  a  distributed  system  of  HTTP  servers 
connected  through  the  World  Wide  Web.   The  current  system  includes 
pointers  to  disparate  DoD  modeling  and  simulation  systems  data,  but  does 
not  provide  seamless  access  to  the  underlying  database  management 
engines.   The  MSRR  consists  of  a  registration  and  catalog  database  which 
holds  information  on  users,  resources,  and  organizations  within  the  M&S 
community.   It  is  designed  to  facilitate  distribution,  integration,  and 
interoperability  between  M&S  programs  and  is  the  infrastructure  for 
various  data  standardization  efforts  under  the  Defense  Modeling  and 
Simulation  Office. 

Portability  and  common  interfaces  are  needed  by  the  MSRR  for 
maximum  utilization  and  distribution  to  the  M&S  community.   Database 
browsing  and  editing  applications  in  Java  would  extend  the  capabilities 
of  the  current  system  and  support  research  of  issues  in  the  design  of 


the  next  generation  MSRR.   A  foundation  for  integration  of  future 
database  connectivity  technologies  needs  to  be  addressed. 

B.  PROBLEM  STATEMENT 

The  focus  of  this  thesis  is  to  design  and  implement  an  object- 
oriented  Java  database  class  hierarchy  for  relational  database 
interfaces.   The  interfaces  will  support  object  access  to  relational 
data . 

This  class  hierarchy  will  be  a  foundation  for  an  object  based 
Modeling  and  Simulation  Resource  Repository.   The  objective  of  the 
prototype  is  to  exercise  object  access  to  a  relational  database.   In 
future  implementation,  the  user  and  resource  data  types  in  the  MSRR 
registration  model  would  be  prime  candidates  for  object  modeling. 

C.  SCOPE 

The  class  hierarchy  is  used  to  demonstrate  the  feasibility  of  an 
object  data  model  for  web  distribution.   The  thesis  consists  of  four 
phases.   The  work  illustrates  the  use  of  the  Java  Database  Connectivity 
(JDBC)  Application  Program  Interface  (API),  two-tier  and  three-tier 
architectures,  and  relational  database  structure  mapping  to  an  object 
model . 

The  first  phase  involve  research  of  the  Java  Database  Connectivity 
specification.  An  understanding  of  the  JDBC  is  needed  to  select 
appropriate  technologies  for  a  limited  prototype.   The  JDBC  API 
available  in  Java  Development  Kit  (JDK)  1.1.3  will  be  used. 

The  second  phase  involves  selection  and  integration  of  a  Java 
based  Network  Application  Server  (NAS)  into  the  overall  architecture. 
The  Application  Server  dynamically  loads  and  executes  modules  when 
required  by  clients.   In  our  example,  the  modules  needing  dynamic  access 
are  different  JDBC  drivers.   The  architecture  supports  two-tier  and 
multi-tier  connection.   An  ODBC  (Open  Database  Connectivity)  interface 
is  also  used  in  illustrating  different  types  of  connectivity.   Several 
NAS  products  were  examined  with  an  appropriate  one  integrated  into  the 
final  prototype. 

An  object-oriented  model  is  used  for  the  representation  of  a 
relational  database  in  phase  three.   The  MSRR  registration  data  model 
was  not  available  for  the  prototype  implementation.   Instead,  a 


representation  of  the  relational  database  physical  structure  was 
created.   The  prototype  demonstrates  Java  access  to  applicable  data 
structures  of  one-one  and  one-many  tables. 

The  object  model  is  limited  to  scope  due  to  time  constraints  but 
supports  minimum  requirements  needed  for  data  population  under  the  MSRR 
data  model.   Several  alternatives  to  the  class  hierarchy  were  found  to 
be  developing  through  the  course  of  this  thesis  but  were  either  infant 
technologies  or  incomplete. 

The  final  phase  involves  prototyping  of  a  Java  database 
application  client.   The  application  was  demonstrated  on  Unix  and 
Windows  NT  operating  systems.   It  includes  a  schema  module,  data 
browsing  module,  and  data  editing  module,  and  a  connection  module.   The 
connection  module  illustrates  two-tier,  multi-tier  and  ODBC  (Open 
Database  Connectivity)  operation.   Other  modules  envisioned  but  outside 
the  scope  of  this  thesis  are:  CORBA  (Common  Object  Request  Broker 
Architecture)  module  and  OODBMS  (Object  Oriented  Database  Management 
System)  module. 

A  test  site  of  current  MSRR  databases  were  available.   Current 
identified  systems  include  an  Oracle  database  and  Microsoft  Access 
database  residing  on  an  Intel  Pentium  server.   Microsoft's  Windows  NT 
operating  system  is  being  used  due  to  lower  software  costs  and 
availability  of  ODBC  software. 


II.  BACKGROUND 

A .  JAVA 

Java  was  originally  a  language  developed  to  program  electronic 
devices  like  VCRs  and  remote  controls.   Java  is  a  "simple,  object- 
oriented,  network-sawy,  interpreted,  robust,  secure,  architecture 
neutral,  portable,  high-performance,  multi-threaded,  dynamic 
language" [Ref  1,  p4]  developed  by  Sun  Microsystems.   Java  can  take  the 
form  of  three  separate  languages:   BASIC-like  interpretive  scripting 
known  as  javascript;  web  browser  extensions  with  limitations  in  memory, 
file,  and  database  access  known  as  applets;  and  a  full  development 
language  without  the  restrictions  for  applications  [Ref  2.]. 

Java  is  a  partially  compiled  language.   Java  syntax  was  designed 
to  resemble  C++  to  take  advantage  of  the  industry  proliferation  of  C++ 
training.   The  Java  Virtual  Machine  (JVM)  is  the  core  technology  that 
makes  Java  portable.   The  JVM  executes  byte  codes  which  are  compiled 
instructions  at  the  lowest  level  possible  without  making  them  machine 
dependent.   Byte  codes  make  Java,  80%  compiled  and  20%  interpreted  at 
run  time. 

Java  is  fully  object-oriented  including  dynamic  binding  but  only 
supports  single  inheritance.   Pointers,  references,  friend  functions, 
operator  overloading,  and  direct  memory  allocation  and  deallocation  are 
not  allowed  in  Java.   These  restrictions  are  needed  to  make  Java  simple 
and  robust. 

B.  MSRR 

The  Modeling  and  Simulation  Resource  Repository  (MSRR)  is  an 
information  repository  shared  by  the  modeling  and  simulation  community. 
Funded  by  the  Defense  Modeling  and  Simulation  Office  (DMSO) ,  the  MSRR 
integrates  various  armed  services  web  sites  under  a  common  registration 
and  resource  model  accessible  by  web  browsers.   The  system  is  being 
developed  under  a  five-year  spiral  development  plan  currently  in  its 
second  year.   The  MSRR  is  deployed  on  the  Internet  for  the  unclassified 
customers  and  SIPRNet  (Secret  IP  Routing  Network)  for  the  classified 
community. 

The  requirements  for  the  MSRR  were  developed  to  identify  needs  for 
a  web  based  information  network  up  to  the  year  2000.   Support  for  legacy 


systems,  mainly  relational  database  systems,  and  future  integration  with 
DMSO's  HLA  (High  Level  Architecture),  distributed  object  architecture 
for  future  models  and  simulations,  drive  the  incremental  prototyping  of 
the  system. 

C.  ARCHITECTURE  CONSIDERATIONS 

In  the  design,  the  client-server  architecture  will  be  used  (Figure 
1) .   A  traditional  application  program  that  wanted  to  access  a  database 
called  its  own  data  management  libraries,  or  started  its  own  invocation 
of  the  DBMS  program.   Disadvantages  to  this  approach  were  wasted 
computer  resources  and  limited  support  of  transactions  across  multiple 
programs  and  users.   In  a  client-server  environment,  a  single  multi- 
threaded DBMS  starts  up  before  any  client  program.  Client  requests,  in 
the  form  of  queries  or  updates,  are  received  over  the  network  by  the 
DBMS,  which  sends  back  data  (SQL  rows  or  status  information)  in  response 
to  each  request.   This  illustrates  a  two-tier  architecture  between  the 
application  and  the  database  management  system. 

Problems  with  traditional  two-tier  architecture  have  become 
apparent.  In  the  RDBMS  market,  each  vendor  supports  a  different  variant 
of  SQL.  Consequently,  vendors  supply  a  different  client  library  with  a 
proprietary  API  for  communicating  with  its  servers,  such  as  DBLIB  for 
Sybase  or  OCI  for  Oracle.   The  application  logic  is  completely  different 
to  communicate  with  DBMS  servers  from  different  vendors.  Microsoft's 
Open  Database  Connectivity  (ODBC)  is  an  attempt  to  standardize  the 
interface,  but  it  offers  a  lowest  common  denominator  approach  and  is 
seldom  fully  implemented.   Both  the  DBMS-vendor  client  libraries  and 
ODBC  suffer  from  too  low-level  an  abstraction.  Writing  code  that  deals 
with  fetches  and  updates  on  individual  records  is  the  norm,  rather  than 
high-level  operations  on  sets  of  records. 
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Application  Client 
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Figure  1:   Client-Server  Architectures 


Client  applications  are  usually  deployed  on  desktop  PCs  with 
limited  memory  and  disk  capacity.   As  Java  and  network  computing  is 
embraced,  the  requirements  of  a  two-tier  system  cannot  be  satisfied  by 
the  new  breed  of  thin-client  systems.   Consequently  with  client-server 
applications  and  the  PC  operating  systems  become  larger  and  more 
complex,  the  cost  to  equip  every  client  PC  with  appropriate  software 
becomes  prohibitive.  In  a  large  organization,  client  programs  may  reside 
on  thousands  of  network  PCs.  Each  time  a  DBMS  vendor  comes  out  with  a 
new  revision,  client  libraries  must  be  updated  on  every  PC,  which  is 
expensive  as  well  as  a  system  management  configuration  problem. 


A  multi-tier  architecture  has  developed  to  address  these  problems. 
Multi-tier  architecture  (also  known  as  three-tier  or  middleware)  extends 
the  standard  client-server  architecture  (two-tier)  by  placing  a  multi- 
threaded application  server  between  the  client  and  the  DBMS.  Clients 
communicate  with  the  DBMS  through  the  application  server,  using  high- 
level,  vendor- independent  requests  and  replies.  The  application  server 
also  provides  the  seamless  network  communication  for  software  components 
physically  distributed.   The  application  server  is  responsible  for 
executing  those  requests,  and  interfaces  with  the  DBMS  vendor's  client 
library  to  communicate  with  databases.  This  third  tier  is  used  to  allow 


portability  between  different  database  engines.   The  Java  application  is 
utilized  as  a  client  denoting  the  first  tier.   The  second  tier  is 
occupied  by  a  Java  application  server  which  handles  the  passing  of  info 
between  the  client  and  the  third  tier,  the  database  itself. 

The  prototype  application  will  demonstrate  three  methods  of 
connectivity:  two-tier,  three-tier,  and  an  ODBC  bridge.   Besides  ease  of 
use,  connectivity  configuration  will  also  be  examined.   A  commercially 
available  network  application  server  and  JDBC  driver  will  be  used. 
Development  of  a  NAS  and  JDBC  driver  is  beyond  the  scope  of  this  thesis. 
Commercial  products  are  rapidly  being  introduced  to  address  the  NAS  and 
JDBC  market . 


III.  PHASE  1:  RESEARCH  IN  DATABASE  SPECIFICATIONS 
A.  RELATIONAL  DATABASES 

The  Relational  Database  Management  System  (RDBMS)  was  developed  to 
implement  the  Entity-Relationship  model.   The  ER  model  characterizes  the 
information  world  into  entities  and  relationships  between  entities.   These 
entities  or  relationships  could  be  modeled  into  two  dimensional  data 
structures  known  as  tables.   Tables  consist  of  rows  and  columns  to  map  a 
particular  data  element.   Columns  can  be  designated  as  keys,  primary  or 
foreign,  which  are  constrained  to  be  unique  values  for  every  row  occurrence. 
A  primary  key  denotes  a  column,  or  set  of  columns,  where  its  data  value  allows 
a  particular  row  to  be  unique  among  the  other  rows  in  its  table.   A  foreign 
key  consists  of  a  column,  or  set  of  columns,  which  map  a  particular  row  to 
another  row  in  a  related  table. 

SQL  is  the  non-procedural  language  used  to  access  data  within  a  RDBMS. 
SQL  is  an  evolving  standard  adopted  by  various  standards  bodies  with  most 
major  vendors  supporting  some  flavor  (often  SQL92)  of  the  language.   SQL  is 
blocked  into  transactions  and  does  not  flow  with  normal  program  structures. 
This  problem,  known  as  impedance  mismatch,  is  partially  solved  through  the  use 
of  cursors  which  transverse  data  sets  by  retrieving  a  row  at  a  time. 

SQL  can  be  classified  into  the  following  types:   DQL  (data  query 
language) ,  DDL  (data  definition  language)  and  DML  (data  manipulation 
language) .   The  DQL  encompasses  the  commands  and  terms  need  to  access  the 
data;  the  DDL  commands  allow  for  creation  of  the  entities;  consequently  DML 
commands  are  used  to  edit  existing  entities. 

Language  designers  needed  to  describe  set  manipulations  for  relational 
data.   The  choice  of  SQL  was  to  make  each  statement  stateless  and  to  embed  the 
code.  SQL  was  developed  as  a  means  to  express  relational  calculus  in  a  fair 
compromise  between  the  needs  of  traditional  third-generation  language 
programmers  and  set  theory  [Ref.  3,  p.  22].   Embedded  SQL  within  program 
statements,  iscompiled  through  a  preprocessor  and  translated  into  functions. 

The  following  command  constructs  are  supported  in  this  Java  prototype: 


SQL  Type 

Commands 

DQL 

select 

DDL 

insert 

DML 

update,  delete 

Table  1.  SQL  Commands 

ODBC  was  a  mechanism  for  Microsoft  to  force  RDBMS  vendors  to  talk 
the  same  language.   It  was  a  first  step  in  providing  portable 
application  integration  but  proved  to  be  slow  and  unwieldy.   Poor 
syntax,  distorted  error  messages,  and  difficult  installations  were  the 
norm.   Future  revisions  have  somewhat  improved  the  performance  of  ODBC 
interfaces  but  client  installation  still  was  not  very  scalable  in  the 
enterprise  environment. 

B.  JAVA  DATABASE  CONNECTIVITY  SPECIFICATION 

JDBC  is  based  on  the  xOpen  standard  of  ODBC.  ANSI  SQL92  is 
required  for  full  JDBC  compliance.   JDBC  is  an  extension  to  the  Java 
language  under  the  java.sql  package  and  has  become  standard  in  release 
1.1  of  Java.   Two  interfaces  are  available  in  JDBC:  JDBC  API  and  JDBC 
Driver  API.   Most  database  application  programmers  will  use  the  JDBC  API 
while  most  RDBMS  vendors  will  use  the  JDBC  Driver  API  for  native 
libraries . 

The  JDBC  API  is  known  as  a  'call  level'  API  where  it  supports  the 
passing  of  raw  SQL  statements  to  the  underlying  DBMS  driver  [Ref .  4] . 
The  classes  that  are  most  dealt  with  for  database  interfaces  are: 
Java . sql .Connection,  Java . sql . Statement ,  Java. sql .ResultSet ,  and 
Java  .  sql .DriverManager .   The  interface  registers  with  the  DriverManager 
which  keeps  track  of  various  Connections  to  external  databases.   A 
DriverManager  allows  loading  of  a  particular  driver;  a  Connection 
represents  a  connection  to  a  particular  instance  of  a  database  using  a 
selected  driver;  a  Statement  contains  the  executing  SQL  statement  for  a 
given  connection;  and  a  ResultSet  provides  access  to  the  row  results  for 
a  given  statement.    Figure  2  provides  a  description. 

Databases  are  identified  by  a  JDBC  Uniform  Resource  Locator  i.e. 
jdbc :< sub-protocol >: <DBMS  specific  identif ier> .   There  are  also  security 
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limitations  for  applets  using  JDBC :  the  Java  Security  Manager  requires 
untrusted  applets  to  only  access  the  sources  from  the  server  from  which 
it  was  loaded.   This  limitation  resulted  in  a  decision  to  implement  the 
prototype  client  as  an  application  rather  than  applet. 


Application  space                               forciass 

ir 

DriverManager 

Connection 

^"^      getConnection 

createStateme 

it 

r 

JDBC  Space 

Statement 

executeQuery 

»                       ResultSet 

getMoreResults 

getXXX 

XXX  denotes   a   datatype 
i.e.     int,    String, long           ▼ 

Figure  2 .  JDBC  API  Components 

The  JDBC  Driver  API  encompasses  the  above  classes  but  as  native 
interfaces  to  the  underlying  DBMS.   This  requires  Java  bridges  to  C 
libraries  since  many  major  DBMS  vendors  do  not  yet  support  Java  client 
software.   Non-DBMS  vendors  have  developed  various  drivers  for  many  of 
the  major  RDBMS  engines.   An  obvious  drawback  is  the  non-portability  of 
the  native  bridge  solution  compared  to  completely  pure  Java. 

No  matter  what  JDBC  driver  is  being  used,  the  normal  steps  needed 
to  interface  with  the  database  are: 

1.  Import  java.sql  package 

2.  Load  a  JDBC  Driver  using  the  DriverManager 

3 .  Open  a  connection  to  the  database  by  providing  at  least  JDBC 
URL,  account  name  and  password 
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4 .  Create  and  execute  the  SQL  Statement 

5 .  Retrieve  the  ResultSets  or  SQL  Error  Code  from  the 
connection 

6.  Decompose  and  translate  the  data  values  into  appropriate 
Java  data  types 

7 .  Close  the  connection 

Program  code  examples  are  included  in  the  Appendix  under  the 
MainFrame . java  functions. 
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IV.  PHASE  2:  SYSTEM  CONFIGURATION 

A.  NETWORK  APPLICATION  SERVER  SELECTION 

A  NAS  needed  to  be  selected  for  three-tier  connections.   Rather  than 
develop  one  from  scratch,  an  appropriate  commercial  off-the-shelf  (COTS) 
product  was  procured.   The  MSRR  project  requires  a  "pure"  Java  implementation 
and  platform  compatibility  for  Sun,  Hewlett-Packard,  and  Windows  NT. 

For  the  Java  prototype,  an  Oracle  JDBC  driver  developed  by  WebLogic  and 
the  JDBC-ODBC  Bridge  developed  by  Sun  Microsystems  are  used.  The  WebLogic 
network  application  framework  supports  both  two-tier  and  three-tier 
connections  while  the  JDBC-ODBC  implements  a  two- tier  connection.   The  burden 
of  the  network  and  driver  management  would  fall  to  the  NAS.   A  suitable  design 
is  illustrated  in  Figure  3 . 


Driver 
Interfaces 


Java  Application 


JDBC  Manager 


Sun  Microsystems 
JDBC/ODBC  Bridge 


Microsoft  ODBC  Driver 


Microsoft  Access 
Database 


JDBC  API 


JDBC  Driver  API 


WebLogic 
JDBCT3  Driver 


WebLogic 
T3Server 


Oracle  Database 


Figure  3.   Architecture  of  Driver  Interfaces 
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B.  WEBLOGIC  T3SERVER 

WebLogic  has  developed  a  multi-tier  Java  application  framework  for 
client-server  computing.   Its  T3Server  environment  provides  solutions 
for  database  connectivity,  event  management,  and  remote  computing. 
Since  the  T3Server  is  completely  written  in  Java,  the  product  provides 
straightforward  interfaces  to  the  JDBC  API.   WebLogic  also  provides  a 
JDBC  driver  suite  (jdbcT3)  which  supports  both  two-tier  and  three- tier 
implementations.   For  this  prototype,  a  T3Server  with  jdbcT3  was 
procured  to  support  Oracle  and  Microsoft  Access. 

C.  NETSCAPE  LIVEWIRE 

Another  alternative  to  JDBC  that  was  examined  but  not  selected  is 
Netscape's  LiveWire  application  suite.   LiveWire  is  a  client-server 
architecture  that  extends  the  web  server  interface.   Because  Netscape 
developed  LiveWire,  it  can  only  extend  its  suite  tools,  Enterprise  Server 
resulting  in  non-portability  of  developed  code.   The  code  supported  by  the 
LiveWire  server  application  is  javascript  through  a  three-tier  client-server 
architecture.   Clients  are  web  browsers  that  can  handle  application  logic  like 
data  validation.   The  servers  are  the  relational  database  management  systems, 
which  house  the  data,  metadata,  and  enforce  referential  integrity.   The  web 
HTTP  server  with  the  LiveWire  extension  performs  the  middle  tier  or  middleware 
application.   This  extension  resembles  the  common  gateway  interface  client  but 
uses  the  javascript  parameter  passing  rather  than  an  html  form  parameter. 
Given  LiveWire' s  dependence  on  javascript,  the  product  was  not  used  in  the 
prototype . 


D.  SYMANTEC  DBANYWHERE 

Symantec's  dbANYWHERE  Workgroup  Server  provides  three-tier 
client/server  database  connectivity.  It  is  thoroughly  integrated  with 
Symantec's  Visual  Cafe  Pro,  a  Java  graphical  user  interface  builder,  for 
its  Java  connectivity.   DbANYWHERE  supports  design  time  database 
interaction  and  facilitates  the  generation  of  database  aware  (dbAWARE) 
Java  forms  that  communicate  with  databases  through  the  dbANYWHERE 
server.  DbANYWHERE  can  access  Oracle,  Sybase,  MS  SQL  Server,  Sybase  SQL 
Anywhere,  and  MS  Access  databases,  and  includes  an  ODBC  link  that 
provides  connectivity  to  over  30  other  databases  with  the  addition  of  an 
ODBC  driver. 
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One  of  the  shortcomings  of  the  product  though  was  the  integration 
of  Cafe  Pro.   Cafe  Pro  offers  another  toolkit  that  extends  the  Java  AWT 
(Abstract  Window  Toolkit)  API.   Visual  Cafe  utilizes  GUI  components 
known  as  DataWizards.   The  DataWizards  automatically  generates  Java  code 
to  perform  SQL  commands  on  a  selected  database  and  its  tables.   For 
example,  DataWizard  buttons  for  fetching,  updating,  and  deleting  are 
made  available  to  your  application  by  dragging  the  component  onto  your 
program's  window  frame.   The  Java  code  generated  is  DbANYWHERE  API  calls 
which  in  turn  call  the  JDBC  API.   Since  one  of  the  objectives  is  to 
exercise  straight  JDBC  calls,  the  DataWizard  code  did  not  fulfill  that 
requirement.   Separating  DbANYWHERE  and  Visual  Cafe  Pro  to  exercise  the 
thesis  objectives  was  not  possible  as  the  generated  code  referred  to 
database  functions  that  were  not  documented  in  the  software  help 
package . 
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V.  PHASE  3:  DATABASE  DESIGN 

A.  DESIGN  OF  DATABASE  OBJECT  MODEL 

In  order  to  map  a  relational  data  model  to  an  object  oriented 
language,  an  object  model  was  devised.   The  representation  of  the 
relational  model  as  objects  allows  Java  structures  to  facilitate  data 
exchange  between  the  database  management  system  and  the  Java 
application.   The  object  model  at  a  minimum  needs  to  support  schemas, 
tables,  and  columns.   Other  entities  like  indexes,  views,  and  synonyms 
are  modeled  but  not  fully  implemented. 

An  object  representation  of  the  table  structure  (Figure  4)  is 
useful  in  developing  graphical  user  interfaces  to  the  data.   The  most 
useful  entities  within  the  relational  model  are  the  schema,  table,  and 
column.   A  particular  database  can  hold  several  schemas;  a  schema  can 
hold  many  tables;  and  a  table  can  contain  several  columns. 


package 
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DataPrecision 
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PrimaryKey 

ForeignKey 


ViewName 
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Figure  4.  Database  Object  Model 

Impedance  mismatching  makes  object  modeling  of  a  relational 
database  a  problem.   An  object  with  its  attributes,  associations,  and 
behaviors  does  not  fit  nicely  into  a  flat  row  and  table  structure  [Ref. 
5.].   There  is  also  the  issue  of  storing  and  retrieving  objects.   The 
simplest  and  most  direct  mapping  from  a  relational  to  an  object  schema 
is  the  one-to-one  mapping  of  a  table  to  a  type,  and  the  mapping  of 
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columns  in  a  table  to  properties  in  a  type  known  as  TTM  (Table-to-Type 
Mapping)  as  discussed  in  Ref.  6.   The  mapping  normally  results  in  single 
types  but  also  can  take  the  form  of  multiple  types  like  different 
columns  of  the  same  table  map  to  two  non-inheriting  types.   The  four  TTM 
approaches  are: 

1.  table-to-type 

2 .  table-to-multiple-types 

3 .  table-to-inherited- types 

4.  multiple-tables-to-inherited-types  (type-tree) 

Since  this  was  a  prototype  for  feasibility,  the  simple  table-to- type 
mapping  was  used  throughout  the  model.   An  exercise  in  table-to- 
multiple-types  would  be  necessary  to  support  the  MSRR  registration  data 
model . 

Typically,  a  type  will  include  mappings  for  all  of  the  columns; 
however  optimally  there  would  be  no  requirement  that  all  columns  in  a 
table  be  mapped  to  properties.   Then  the  type  could  be  defined  to 
include  only  mappings  to  properties  for  those  columns  required  by 
applications.   Mapping  the  primary  key  is  not  a  requirement  especially 
when  the  key  provides  no  extra  value  besides  providing  a  unique 
identifier  for  the  tuple.   This  rule  provides  a  degree  of  flexibility  in 
the  model.  [Ref  6,  p.  72] 

The  relational  classes  are  developed  under  the  DbJava . relational 
package.   The  relational  classes  will  be  used  to  contain  the  data 
retrieved  from  the  RDBMS  into  an  object  that  can  easily  be  manipulated 
by  Java  operations.   There  is  a  semantic  mismatch  between  the  object 
syntax  and  procedural  constructs  of  the  relational  model.   One  of  the 
benefits  of  object  syntax  was  ease  of  maintenance  and  reduced 
complexity.   Integrating  a  relation  model  for  data  persistence 
contradicts  these  two  benefits  of  object  programming. 

The  relational  model  delivers  data  in  the  form  of  two-dimensional 
matrixes  (column  and  row) .   JDBC  implements  the  matrix  in  the  form  of  a 
Java . sql .ResultSet .   In  order  to  access  the  data,  two  cursors  are  needed 
to  transverse  the  matrix.   By  specifying  a  row  and  column  cursor,  the 
data  value  can  be  retrieved  then  translated  to  an  appropriate  object 
type  needed  for  a  particular  class.  Some  object  instances  may  require 
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its  data  to  be  stored  in  separate  rows  in  different  tables.   One 
initialization  statement  in  Java  can  result  in  20  or  more  JDBC  execution 
statements  to  retrieve  data  to  populate  the  object.    This  interface 
introduces  more  complexity  but  can  not  be  avoided. 

Most  information  needed  to  describe  a  data  value  resides  in  the 
DbJava. relational .DataColumn  class.   The  DataColumn  describes  the  data 
type  (string  or  number  or  date),  precision  (if  number,  digits  after  the 
decimal  point),  and  scale  (size  of  number  or  length  of  characters)  . 
Other  attributes  available  are  whether  the  column  could  be  null 
(nullable)  and  if  the  column  is  a  primary  or  foreign  key.   Primary  and 
foreign  keys  could  have  also  been  modeled  as  sub-classes  of  the 
DataColumn  class,  but  they  were  relegated  to  attributes  to  simplify  the 
class  hierarchy. 

Vector  classes  (dynamic  array  data  structures)  were  used  to 
represent  the  one-to-many  relationships  between  schemata  to  tables  and 
tables  to  columns.   Vectors  provide  convenient  accessor  and  destroyer 
functions  to  simplify  coding.   Though  vectors  provide  built-in  behavior 
for  managing  the  array,  it  still  requires  multiple  loops  and  casting 
calls  to  finally  retrieve  data.   This  cumbersome  technique  was  a 
disadvantage  in  using  JDBC.   Oracle  has  responded  to  this  shortfall  by 
proposing  a  standard  known  as  J/SQL.   J/SQL  will  be  discussed  in  a  later 
section. 

The  DataRecordTextField  class  was  needed  to  translate  non-string 
or  non-numeric  data  types  into  the  DBMS  data  types.   Here  is  where  the 
legacy  of  dynamic  SQL  is  still  apparent.   JDBC  driver  transforms  the 
data  value  into  appropriate  Java  data  types,  but  the  programmer  still 
has  the  ability  to  convert  between  different  Java  types  like  a  Integer 
type  can  be  retrieved  as  a  String  type.   This  was  appropriate  for  the 
date  data  type  as  java.Date  class  did  not  match  the  Oracle  date  type. 
For  future  development,  the  construction  of  distinct  GUI  collections  or 
objects  that  support  the  editing  and  display  of  each  unique  data  type 
would  be  more  useful  i.e.  MSRR  requirement.   Examples  are  a  date 
spinner,  combo  boxes  and  check  boxes  for  enumerated  data  types,  and 
radio  button  groups  for  a  boolean  data  type. 
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VI.  PHASE  4:   DESIGN  OF  DBJAVA  MODULES 

A.  PACKAGE  DESCRIPTION 

The  prototype  client  application  is  not  discussed  in  detail  as  the 
program  code  is  provided  in  the  Appendix.   A  general  discussion  follows. 

The  package  DbJava  contains  the  code  for  the  Java  application 
client.   DbJava. relational  module  holds  the  description  of  the  database 
entities.   From  the  passing  of  a  DataSchema  object  to  the  BrowseFrarae, 
EditFrame,  MetaDataFrame,  or  SchemaFrame,  the  frame  is  populated  and 
configured  per  the  database  entity  description.   Though  different  GUI 
objects  are  used  in  the  various  frames,  one  single  object  (DataSchema) 
is  the  target  for  all  manipulations. 

This  design  in  the  application  followed  the  MVC  (model-view 
controller)  design  pattern.   The  model  was  provided  by  the 
DbJava . relation  package;  the  view  was  developed  in  all  the  frame 
objects;  while  the  controller  was  implemented  in  the  frame  operations. 
MVC  is  a  design  pattern  first  used  in  the  Smalltalk-80  programming 
language  to  separate  data,  GUI,  and  application  logic. 

The  design  philosophy  is  to  present  data  in  different  views 
configured  by  independent  controllers.   MVC  decouples  views  and  models 
by  establishing  a  subscribe/notify  protocol  between  them.   A  view  must 
ensure  that  its  appearance  reflects  the  state  of  the  model.   Whenever 
the  model's  data  changes,  the  model  notifies  views  that  depend  on  it. 
In  response,  each  view  gets  an  opportunity  to  update  itself.   This 
approach  let  you  attach  multiple  views  to  a  model  to  provide  different 
presentations  [Ref.  7].   Figure  5  provides  the  class  GUI. 
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Figure  5.  Graphical  User  Interface 


B.  FRAME  MODULES 


The  MainFrame  (Figure  6)  is  where  user  and  database  information  is 
specified.   This  is  also  the  connection  module.   With  user  information, 
the  client  can  connect  to  the  T3Server  through  a  three-tier,  two-tier, 
and  ODBC  bridge  interface.   A  message  box  is  also  provided  for  error 
information,  normally  networking,  driver  configuration,  and  database 
availability.   After  connection,  the  MainFrame  pages  to  the  main  panel 
(Figure  7) .   This  panel  allows  selection  of  a  table  in  the  connected 
database  to  be  accessed  in  different  modes:  browse,  edit,  meta-data,  and 
schema.   A  disconnect  mode  is  also  provided  to  allow  the  user  to  exit 
and  clear  all  current  connections. 
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Figure  6 :  MainFrame  Connection  Screen 
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Figure  7 :  MainFrame  Database  Tables  Screen 
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The  BrowseFrame  (Figure  8)  allows  browsing  of  all  rows  in  a  table. 
Popups  are  created  which  display  all  unique  entries  for  each  column.   A 
fetch  button  selects  all  rows  within  the  selected  table  by  retrieving  a 
DataSet  of  the  table.   A  next  button  displays  each  individual  row  in  the 
DataSet  through  the  textfields. 

The  EditFrame  (Figure  9)  allows  editing  of  particular  rows  in  a 
table.  Insertion  of  new  rows  is  also  allowed  in  this  mode  along  with 
updating  and  deleting  rows. 

The  MetadataFrame  (Figure  10)  was  designed  to  take  advantage  of 
metadata  operations  provided  by  JDBC .   JDBC  implements  a 

Java . sql .MetaData  class  but  vendor  support  has  been  inconsistent  at  this 
point  of  time.   Oracle  did  not  support  the  catalog  object  and  its 
accompanying  function  calls  in  Java. 

The  SchemaFrame  module  constructs  a  graphical  representation  of  a 
selected  database  schema.   This  module  would  be  useful  as  a 
documentation  or  reverse-engineering  tool.  It  was  not  fully  implemented 
because  of  time  constraints  but  the  basic  skeleton  needed  for  component 
drawing  was  developed  through  the  SchemaCanvas  class.   With  a 
SchemaCanvas  object,  each  individual  drawing  of  a  table  represented  an 
instance  of  this  class.   This  specification  offered  the  flexibility  to 
extend  the  class  for  added  functionality  without  affecting  the 
SchemaFrame  object  itself. 
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Figure  10:  MetaData  Screen 
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VII.  IMPLEMENTATION  INSIGHTS 


A.  SERVER  -  CLIENT  MAINTENANCE 

The  two-tiered  architecture  required  client  libraries  on  client 
and  server  machines.   Even  though  the  JDBC  driver  was  installed  on  the 
client  machine,  a  network  protocol  driver  for  the  database,  like  SQLNet 
for  Oracle,  was  also  required.   Microsoft  Access  did  not  support  this 
architecture  as  no  JDBC  drivers  existed  for  it.   Access  was  dependent  on 
the  ODBC  Bridge  because  of  its  market  target  as  a  personal  computer  tool 
rather  than  enterprise  solution. 

When  the  client  application  and  database  were  on  the  same  machine, 
no  connection  errors  were  witnessed.   A  local  connection  was  the 
preferred  installation  since  the  actual  DBMS  libraries  were  available  to 
the  Java  application  if  available  on  the  user's  environment  path.   This 
situation  is  strictly  limiting  in  the  remote  and  distributed  computing 
configuration  but  was  ideal  for  single  system  installations. 

The  ODBC  Bridge  was  the  least  effective  of  all  connections. 
Except  for  the  Microsoft  Access  interface,  ODBC  suffered  inconsistent 
connection  performance  and  was  very  particular  about  the  ODBC 
configuration  of  the  underlying  operating  system.   Sun  Microsystems 
provides  the  bridge  with  caveats  for  application  use  and  strongly 
recommends  using  a  pure  JDBC  driver  for  enterprise  systems.   The  ODBC 
Bridge  is  recommended  for  use  in  applet  development  and  JDK  1.0.2  and 
JDK  1.1.1. 


B.  SCALABILITY 

The  three-tier  architecture  offered  the  best  scalability  due  to 
connection  management.   A  two-tier  model  forces  the  database  server  to 
have  as  many  concurrent  connections  as  possible.   Every  client 
application  that  connects  to  the  DBMS  must  maintain  a  persistent  state 
in  order  to  support  SQL  transactions.   With  the  three-tier  model,  the 
application  server  maintains  one  connection  to  the  database  but  manages 
transactions  through  multi-threaded  processes.   It  is  unlikely  that  a 
NAS  will  be  as  large  and  cumbersome  as  a  RDBMS . 
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C.   IMPEDANCE  MISMATCHING 

The  mismatch  of  an  object  and  relational  object  resulted  in  large 
and  cumbersome  code  for  data  retrieval .   Oracle  has  proposed  the  use  of 
a  prepocessor  for  embedded  SQL  in  Java.   The  preprocessor  detects  type 
mismatch  and  provides  some  bookkeeping  functions.   The  design  proposal 
is  too  new  for  examination  but  Oracle  predicts  10  lines  of  J/SQL  code 
replacement  for  50  to  100  lines  of  JDBC  code.  [Ref  3,  p. 24] 
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VIII.  FUTURE  WORK 


For  future  development,  the  MSRR  is  required  to  support  the 
following  object  technologies:  CORBA  and  an  OODBMS .   Both  will  have 
strong  support  in  development  of  Java  solutions  because  of  the  object 
nature  of  their  technology. 

A.  CORBA 

CORBA  (Common  Object  Request  Broker  Architecture)  is  an  object 
middleware  architecture  provided  by  the  Object  Management  Group  (OMG) ,  a 
consortium  of  700+  companies.   CORBA  allows  intelligent  components  to 
discover  each  other  and  inter-operate  over  an  object  bus.   The  bus, 
known  as  an  ORB  (Object  Request  Broker)  allows  an  extensive  set  of 
services  like  creating  and  deleting  objects,  accessing  other  objects, 
persistent  storage,  and  defining  ad-hoc  relationships  [Ref.  8,  p  7-14]. 
For  more  details  on  CORBA,  the  OMG  Publication,  "Essential  CORBA"  by 
Thomas  Mowbray  and  Ron  Zahavi  is  recommended  [Ref.  9]. 

A  component's  boundaries  are  defined  through  an  interface 
specification  known  as  IDL  (Interface  Definition  Language).   IDL  is  ■ 
portable  across  languages,  tools,  operating  systems,  and  networks.   IDL 
is  declarative  and  provides  no  implementation  details.   CORBA  1.1 
specified  IDL,  language  bindings,  and  an  ORB  API.   CORBA  2.0  introduces 
interoperability  between  vendor  ORBs  (HOP,  Intenet  Inter-ORB  Protocol)  . 

The  MSRR  system  would  take  advantage  of  HOP  in  integration  for 
the  forthcoming  object  based  models  and  simulations  of  HLA.   Currently, 
java  based  ORBs  are  available  from  Visigenic  and  will  be  included  in 
upcoming  versions  of  Netscape's  web  browser.   This  ORB  is  a  prime 
candidate  to  replace  the  Weblogic  T3Server  if  relational  database 
support  is  provided.   If  relational  support  is  lacking,  an  application 
layer  before  the  ORB  and  JDBC  will  need  to  be  developed.   Extension  of  a 
proxy  server  to  preprocess  messages  between  HTTP  and  HOP  requests  is  a 
viable  solution.   Several  servers  like  Sun  Microsystems  Java  Server  and 
Netscape's  Enterprise  3.0  suite  are  following  that  approach. 
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B.  OODBMS 

An  object  database  can  be  integrated  into  the  MSRR  if  the  CORBA 
design  is  utilized  since  most  OODBMS  are  CORBA  compliant.   OODBMS 
vendors  will  also  support  two-tier  connections  to  their  products  through 
bindings  with  00  languages  like  C++  and  Java. 

The  Object  Database  Management  Group  (ODMG)  has  introduced  ODMG 
2.0,  which  describes  interactions  between  Java  applications,  or  applets 
and  object  oriented  databases.   The  ODMG  Binding  for  Java  specification 
provides  a  standard  API  to  automatically  store  Java  objects  in  object 
compliant  databases.   It  promotes  portability  across  multiple  database 
products  and  is  a  standard  for  object-relational  mapping.   This  solution 
is  projected  to  be  finalized  during  first  quarter  of  1998  and  would  have 
been  more  useful  than  the  Java  database  class  hierarchy. 
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